<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>NS Pro Help</title>
<style><!--

body {
  font-family: Trebuchet MS, serif;
}

#wrapper {
  background-color: #F9F9F9;
  margin: 0 auto;
  width: 940px;
  border: 1px solid #D5D5D5;
}

#header h1 {
  font-size: 35px;
}

#content {
  padding: 15px;
}

span.comparam {
  color: #ff3e00;
  font-size: 25px;
}

span.modparam {
  color: #31f105;
  font-size: 25px;
}

span.plgparam {
  color: #3e9ade;
  font-size: 25px;
}

div.usertip {
  border: 1px dashed #555;
  border-top: none;
  padding: 5px;
}

div.usertipheader {
  padding-left: 5px;
  border: 1px dashed #555;
  border-bottom: none;
  background-color: #ccc;
  font-size: 18px;
  line-height: 30px;
}

--></style>
</head>
<body>
<div style="width: 100%;">
<div id="wrapper">
<div id="header">
<table style="width: 100%;">
<tr><td valign="top" style="width: 380px; padding: 15px;">
<p><h1>NS Pro 1.5 Help</h1></p>
<p>
Contents:
<ol>
<li><a href="#installing">NS Pro Installation</a></li>
<li><a href="#configuring">Configuring NS Pro</a></li>
<li><a href="#introToAdmin">Small Introduction to NS Pro Administrator</a></li>
<li><a href="#introToFront">Small Introduction to NS Pro Front-End</a></li>
<li><a href="#introToModAngPlg">Small Introduction to Module & Plugin</a></li>
<li><a href="#introToCBPlg">Small Introduction to Community Builder Plugin</a></li>
<li><a href="#faqAndErrors">FAQ & Common Problems</a></li>
<li><a href="#whatToRemember">What you should remember</a></li>
<li><a href="#tipsandhints">User Tips & Hints</a></li>
</ol>
</p>
</td><td style="text-align: right;">
<img src="img/nspro-side-banner2.png" width="408"/>
</td></tr>
</table>
</div>
<div id="content">
<p>Hello. My name is <i>Christopher Mavros</i>. I am the developer behind Mavrosxristoforos.com and creator of NS Pro.</p>
<p>This help is mostly targeted to new users, but anyone familiar with NS Pro can read it,<br/>since it contains information "from the inside".</p>
<p id="installing"><center><h3>1. NS Pro Installation</h3></center></p>
<p>Installing NS Pro is an easy procedure. After paying on Paypal, or using the
<a href="http://demo.mavrosxristoforos.com/update.php" target="_blank">Update page</a>, you should get a rar file.</p>
<p>Rar Files are similar to Zip files, only better compressing and produced by WinRar, 7-zip or similar software and freeware.</p>
<p>TheUnarchiver does that for Mac, if needed</p>
<p><strong>Why is NS Pro compressed in a rar file? Can I install that to Joomla!?</strong></p>
<p>NS Pro is compressed in a rar file because some OS do not allow zip files contained in another zip.</p>
<p>You cannot install the downloaded file directly to the Joomla! Install page, because Joomla! cannot extract it.</p>
<p>You should extract it before installing, using WinRar if you have a license, or <a href="http://www.7-zip.org" target="_blank">7-zip</a> which is freeware.</p>
<p>After extracting you should get a directory named NS Pro 1.5 containing 5 files:
<ol>
<li>com_nspro.zip</li><li>mod_newsletter_subscriber_pro.zip</li>
<li>newsletter_subscriber_pro.zip</li><li>NSProCBPlugin.zip <i>(and)</i></li>
<li>README_IN_TEN_SECONDS.txt</li>
</ol>
The last file, contains a guide on what to do after extracting and some additional details about the NS Pro Usage policy.</p>
<p><strong>What to do after extracting?</strong></p>
<p>You need to install the first 3 files as listed above, in any order, in the Joomla! Install page. The 4th file, NSProCBPlugin.zip is the CB Plugin for NS Pro, which can be <strong>optionally</strong> installed in the Community Builder Plugin Manager.</p>
<p>Simple Process:</p>
<p><img src="img/install-3steps.png"/></p>
<p>&nbsp;</p>
<p id="configuring"><center><h3>2. Configuring NS Pro</h3></center></p>
<p>Configuring NS Pro is quite simple, if you know your ways through NS Pro.</p>
<p>Here is a small demonstration of the NS Pro Extension Structure, to give you a clue on NS Pro parameters.</p>
<p><img src="img/nsprointerstruct.png"/></p>
<p>All parameters can only be accessed and changed in the Administrator part of your website.</p>
<p><u>Only a Super Administrator can change the Component Parameters</u>, found in the administrator views of NS Pro:</p>
<p>The <a href="../../index.php?option=com_nspro&view=default" target="_blank">Mailing List Manager</a>, the
<a href="../../index.php?option=com_nspro&view=subscribers" target="_blank">Subscriber Manager</a>, the
<a href="../../index.php?option=com_nspro&view=newsletters" target="_blank">Newsletter Manager</a>, the
<a href="../../index.php?option=com_nspro&view=toolkit" target="_blank">Toolkit</a>, the
<a href="../../index.php?option=com_nspro&view=templates" target="_blank">HTML Templates Manager</a> and the
<a href="../../index.php?option=com_nspro&view=fields" target="_blank">Additional Fields Manager</a>.
</p>
<p>The other two types of parameters, the Module Parameters, and the Plugin Parameters, are accessed from the <a href="../../index.php?option=com_modules" target="_blank">Module Manager</a> and <a href="../../index.php?option=com_plugins" target="_blank">Plugin Manager</a> respectively, by Super Administrators, and Administrators.</p>
<p id="confq1"><strong>Question 1: I want the extension to run asap. How many parameters should I change?</strong></p>
<p>NS Pro is designed to run as is. The only essential change to do, is change the <strong>Mail Recipient</strong><span class="modparam">*</span><span class="plgparam">*</span> parameter to your email.</p>
<p>If you did that and don't receive any notification emails, go to <a href="#faq5">FAQ #5</a> and <a href="#faq6">#6</a>.</p>
<p></p>
<p>Note: In short, you should write your emails for the notifications<span class="comparam">*</span><span class="modparam">*</span><span class="plgparam">*</span>, and your "Mail From"<span class="comparam">*</span><span class="modparam">*</span><span class="plgparam">*</span> used to send emails, as also specified in the <a href="../../index.php?option=com_config" target="_blank">Joomla! Mail Settings</a>. As of version 1.3, the Mail From adapts automatically to your Joomla! Mail Settings.</p>
<p><a href="http://demo.mavrosxristoforos.com/index.php?option=com_content&view=article&id=51:configure-joomla-mail-settings&catid=37:nspro-special-help&Itemid=57" target="_blank">
You can find more help about the Joomla! Mail Settings here.</a></p>
<p></p>
<p id="confq2"><strong>Question 2: Where do I change the texts that are not found in the parameters?</strong></p>
<p>If you can't find a text in the parameters, that means that you should use the language ini files to "translate" it to your desired text.
<a href="http://demo.mavrosxristoforos.com/index.php?option=com_content&view=article&id=52:nspro-ini-files&catid=37:nspro-special-help&Itemid=57" target="_blank">Click here for a guide to changing texts in the language ini files.</a></p>
<p></p>
<p id="confq3"><strong>Question 3: Where can I learn what each parameter does?</strong></p>
<p><a href="http://demo.mavrosxristoforos.com/index.php?option=com_content&view=article&id=50" target="_blank">A full parameter explanation tour is available online here.</a></p>
<p></p>
<p id="confq4"><strong>Question 4: Why is it that the parameters for the module and the plugin are identical, and need to be configured twice?</strong></p>
<p>Because NS Pro doesn't need both parameters configured, to work correctly. You might also want to use two different subscription forms in your site.</p>
<p>You may only use the Plugin Parameters, if you want to ommit the Module.</p>
<p id="confq5"><strong>Question 5: Is that all there is about Parameters in this help?</strong></p>
<p>No. Later on, in the <a href="#faqAndErrors">FAQ & Common Errors</a> section, you can see more tricks with parameters.</p>
<p>&nbsp;</p>
<p id="introToAdmin"><center><h3>3. Small Introduction to the NS Pro Administrator</h3></center></p>
<p>NS Pro has 6 main back-end views.</p>
<p><ul>
<li><a href="../../index.php?option=com_nspro" target="_blank">The Mailing List Manager</a></li>
<li><a href="../../index.php?option=com_nspro&amp;view=subscribers" target="_blank">The Subscriber Manager</a></li>
<li><a href="../../index.php?option=com_nspro&amp;view=newsletters" target="_blank">The Newsletter Manager</a></li>
<li><a href="../../index.php?option=com_nspro&amp;view=toolkit" target="_blank">The Toolkit</a></li>
<li><a href="../../index.php?option=com_nspro&amp;view=templates" target="_blank">The HTML Templates Manager</a> and</li>
<li><a href="../../index.php?option=com_nspro&amp;view=fields" target="_blank">The Additional Fields Manager</a></li>
</ul></p>
<p>NS Pro also has an <a href="../../index.php?option=com_nspro&amp;view=about" target="_blank">About</a> page, that can help you see what features are currently available, check for updates
<br/>and also there is a link to this help page.</p>
<p>The 6 main views in detail:</p>
<p><ol>
<li><b>The Mailing List Manager</b> is where you can manage the lists of subscribers.<br/>
Any non published list is accessible from the back-end (administrator) only.<br/>
The rest of the interface is very simple, almost self explanatory.</li>
<li><b>The Subscriber Manager</b>, is where you manage your subscribers.<br/>
You can filter by the mailing list, by the box found on the right.<br/>
On the toolbar, you can see some basic functions, like New, Edit or Delete.<br/>
You should also see two other buttons.<br/>The first one is called <b>(Re-Send Confirmation)</b>, and is used to send a confirmation email,<br/>
to a subscriber who hasn't confirmed his email address.<br/>
<i>This can also be useful for old lists that you import, if you want to import them as unconfirmed and then send a confirmation to everyone<br/>
to learn who is still a valid subscriber.</i><br/>
The other button is the <b>(Run Bounce Check)</b> button. To use this new functionality, you should configure the Bounce Parameters in the Component Parameters<span class="comparam">*</span>.<br/>
The functionality is simple:<br/>
Connects to a mail account inbox, to find Bounced Emails.<br/>
If any Bounced Email is found, according to your selection, you can delete the subscriber, or set his confirmed status to No.<br/>
<i>Note: NS Pro can only track Bounced Emails sent from NS Pro. Moreover, it is strongly recommended to create a dedicated email account for this.</i><br/><br/>
The Address you specify as the Bounce Address, is the one included as the one to send emails that bounce.<br/>
Then, the Bounce Account Username might be the same as the address, or changed accoring to your host's requests.<br/><br/>
One very important feature about the Bounce Check is that you can specify an automated process for this!<br/>
<b>Obtain your Cron Job Key from <a href="http://demo.mavrosxristoforos.com/obtainkey.php" target="_blank">this page</a> to have Mavrosxristoforos.com trigger a Bounce Check, and do any other scheduled NS Pro "job" in your site, every 30 minutes.</b><br/>
Then write this Key in your Component General Parameters and set the Auto Bounce Check parameter to Yes.<br/>
This way, you can now be sure that your NS Pro subscribers are never out of date, and you won't spend more emails than you need!<br/>
As of version 1.4, you can set a Joomla! user to be deleted if their Email bounces on NS Pro.<br/>
This way, you can even be sure for your Joomla! users, with NS Pro!<br/>
Also, the Auto Bounce Key is now called Cron Job Key and was transferred to the Component's General Parameters.<br/><br/>
Lower in this view, are the <strong>NS Pro Tools</strong>, where you can import and export subscribers.
<p>
As of 1.2.5, the Import System for dates, and confirmed status<br/>has changed to be more flexible and user friendly.<br/>
Here is an import format comparison: (with delimiter ;)<br/>
<table border="1" cellspacing="0">
<tr style="background-color: #999;"><td align="center"><strong>Version 1.2</strong></td><td align="center"><strong>Version 1.2.5+</strong></td></tr>
<tr><td>Tester;old@a.com;<span style="color: #f00;">2010-05-26 12:35:00;1</span>;1,2;</td><td>Tester;new@a.com;<span style="color: #f00;">May 26 2010 12:35:00;True</span>;1,2;</td></tr>
<tr style="background-color: #DDD;"><td>Testar;old@b.com;<span style="color: #f00;">2010-05-28 22:45:00;0</span>;1,2;</td><td>Testar;new@b.com;<span style="color: #f00;">28-05-2010 10:45 pm;F</span>;1,2;</td></tr>
<tr><td>Testor;old@c.com;<span style="color: #f00;">2010-04-30 15:30:00;1</span>;1,2;</td><td>Testor;new@c.com;<span style="color: #f00;">30 April 2010 15:30;Yes</span>;1,2;</td></tr>
<tr style="background-color: #DDD;"><td>Testur;old@d.com;<span style="color: #f00;">2010-05-05 08:15:00;1</span>;1,2;</td><td>Testor;new@d.com;<span style="color: #f00;">2010-05-05T08:15:30+03:00;y</span>;1,2;</td></tr>
</table>
<br/>
For a precise example, including the Extra Fields that you have, you can click on the "<a href="../../../index.php?option=com_nspro&task=import_example&type=txt" target="_blank">Click for Import Example</a>" link next to the Import Types.<br/>
<i>Note: The Excel Separator used depends on the Country and Language you use.
As such, your exported file might not have the default NS Pro Separator
which is the semi-colon (;). If that is the case, you can always change
your computer's list separator by Control Panel->Regional Settings and find the value for "List Separator".</i>
</p>
</li>
<li><b>The Newsletter Manager</b>, is where you manage and send your newsletters.<br/>
When you send a newsletter, it is automatically sent to all subscribers in the newsletter's mailing lists.<br/>
If the newsletter has no lists, it is sent to all subscribers. That simple!<br/>
<p><strong>The New Felxible Sending System</strong> allows you to handle<br/>how many mails you want to send, every time you click "Send".<br/>
This way, <strong>you can pass every host limit</strong>, you can manage your sendings,<br/><strong>and never worry</strong> about a lost email, or a subscriber getting it twice.<br/>
As of version 1.3, NS Pro has de-coupled the sending process from the browser. This means you can click send, and then leave without worrying of fails.<br/>
NS Pro will send your newsletter up to Emails Per Send, or to all your subscribers, whichever comes first.</p>
<p>The flexible sending system allows sending procedure to be split. This way, when the process stops to a percentage, and the "Message(s) Sent"<br/>
info appears, you can click Send again, to continue where you left.</p>
<p><i>Please note that when a newsletter is sent 100%, you have to clear its sending status to send it again.<br/>
If you don't, it will start sending from where it stopped.<br/>(which means that if you sent to all subscribers, and new subscribers came after the newsletter, it will send to the new subscribers)</i></p>
<p>A feature as of version 1.4 is the Scheduled Sending. You can now schedule your newsletters to be sent!<br/>
Although, for this function to work, you need to obtain a Cron Job Key from <a href="http://demo.mavrosxristoforos.com/obtainkey.php" target="_blank">this page</a> an set it to your Component's General Parameters.<br/>
Then, Mavrosxristoforos.com will trigger your site every 30 minutes to check and send any newsletters you have scheduled!<br/>
<i><b>Important Note</b>: Since NS Pro will trigger sending twice per hour, until the email is fully sent,
you should configure the Emails Per Send to <b>half the available emails</b> you have every hour.
This way, it will not exceed your limit, and your newsletter will be completed very soon!</i><br/><br/>
<i>Please also note that your time may be different to your server time, which is the one used.<br/>
To learn your server time you can subscribe using the NS Pro form and see the time of subscription in the back-end.<br/>
It might not be the best way to learn what timezone your server is in, but it works.</i></p>
</li>
<li><b>The Toolkit</b> is a collection of Tools, that can be very useful,<br/>like sending a newsletter by its id to a test email or to a group of emails by selecting them.<br/>
A main purpose of the Toolkit, is to keep the rest of the views as simple as possible.
<p>
As of 1.2.5, the Toolkit hosts the new Statistics, and also tools to quickly create subscribers, and massively assigning to Mailing Lists.<br/>
<br/>As of version 1.4, the Toolkit tool #4 and #6 do not show all the subscribers for less loading time.<br/>
If you want to assign all the subscribers to a mailing list, you can either export and re-import with the list, or follow this link, where all subscribers appear in the toolkit:<br/>
<a href="../../index.php?option=com_nspro&amp;view=toolkit&amp;special=loadallsubs">Toolkit with all subscribers</a>
</p>
</li>
<li><b>The HTML Templates Manager</b> view is where you can manage your HTML Templates.<br/>NS Pro inserts two templates by default, which make up a small demonstration<br/>
of NS Pro's Smart Text and capabilities. Each template consists of a name, a thumbnail, the HTML code and some notes.<br/>
Feel free to <a href="mailto:mavrosxristoforos@gmail.com?subject=NS Pro Help. More HTML Template Fields">request more fields</a> in later versions!</li>
<li>
<b>The Additional Fields Manager</b> view is where you manage your Extra Fields.<br/>
NS Pro, since version 1.4 has the ability to have additional fields, other than the original Name and Email.<br/>
There are 8 Field Types:<br/>
<ol>
<li>Inputbox (a simple text box),</li>
<li>Textarea (a textarea box for text),</li>
<li>Boolean (which shows a Yes or No input),</li>
<li>Radio Buttons (round buttons where user can only select one),</li>
<li>Checkboxes (square boxes where user can select more than one),</li>
<li>DropDown (a box in which the user selects one value),</li>
<li>Multiple Selection DropDown (a list box where user can select more than one values) and</li>
<li>Hidden, which is very useful for Smart Values (like Subscriber's IP address) and for users who want to manage their own post data using other extensions.</li>
</ol>
By creating a new field, you can see more information on the [?] signs next to the Validation Regular Expression field and the Initial Value field.<br/>
NS Pro, has created a simple way for users with small experience to validate their fields' input, with the "smart" Regular Expression shortcuts.<br/>
<br/>Do you have any suggestion on Field Types, Smart Regular Expressions or Smart Initial Values?<br/>
<a href="mailto:mavrosxristoforos@gmail.com?subject=NS Pro Help. I have a suggestion for Extra Fields.">I'd be more than happy to listen to it.</a>
<br/>
</li>
</ol>
</p>
<p><strong>A very important part in 'knowing your way' through NS Pro, is to check the Parameters (or Preferences) in detail.</strong><br/></p>
<p>&nbsp;</p>
<p id="introToFront"><center><h3>4. Small Introduction to the NS Pro Front-End</h3></center></p>
<p>NS Pro also has some front-end views.</p>
<p><ol>
<li><strong>The Default</strong> view, which just shows a subscribe form by including the plugin</li>
<li><strong>The Unsubscribe</strong> view, (parameters are configured from the administrator)</li>
<li><strong>The Edit Mailing Lists</strong> view, which is accessed by including smart text in newsletters</li>
<li><strong>The Edit Subscription</strong> view, which is also accessed by including smart text in newsletters</li>
<li><strong>The Forward to Friend</strong> view, which is again accessed by including smart text in newsletters and</li>
<li><strong>The Newsletter List</strong> view, which gives you the opportunity to show the <strong>already sent</strong> newsletters in the front-end.</li>
</ol>
</p>
<p>To create any of these pages, you need to create a menu item and choose type NS Pro. Then the desired layout.</p>
<p>Here are links to the pages if you don't want to create a menu item:</p>
<ol>
<li>Default: <a href="../../../index.php?option=com_nspro" target="_blank">index.php?option=com_nspro</a></li>
<li>Unsubscribe: <a href="../../../index.php?option=com_nspro&amp;layout=unsubscribe" target="_blank">index.php?option=com_nspro&amp;layout=unsubscribe</a></li>
<li>Edit Mailing Lists: <a href="../../../index.php?option=com_nspro&amp;layout=editlists" target="_blank">index.php?option=com_nspro&amp;layout=editlists</a> (this will print "Link is expired", because it is only accessed by email)</li>
<li>Edit Subscription: <a href="../../../index.php?option=com_nspro&amp;layout=editsub" target="_blank">index.php?option=com_nspro&amp;layout=editsub</a> (this will print "Link is expired", because it is only accessed by email)</li>
<li>Forward To Friend: <a href="../../../index.php?option=com_nspro&amp;task=forwardtofriend" target="_blank">index.php?option=com_nspro&amp;task=forwardtofriend</a> (this will print "Invalid Newsletter ID", because it is only accessed by email)</li>
<li>Newsletter List: <a href="../../../index.php?option=com_nspro&amp;layout=newsletterlist" target="_blank">index.php?option=com_nspro&amp;layout=newsletterlist</a> (only shows newsletters marked as "Sent")</li>
</ol>
<br/>
The <b>Default</b> view shows the Subscribe plugin. The <b>Unsubscribe</b> view shows a form to unsubscribe.<br/>
The <b>Edit Mailing Lists</b> page shows a form where a subscriber can change their subscriptions (mailing lists).<br/>
The <b>Edit Subscription</b> page was introduced in version 1.4 and allows the subscriber to change all their subscription information except for the email.<br/>
The <b>Forward To Friend</b> is a page with a form to send a newsletter to a friend. This is a useful page,<br/>
because when users forward the newsletter using their email clients, they forward the "Unsubscribe" links,<br/>
which might result in their deletion, if the "friend" clicks on it.<br/>
The <b>Newsletter List</b> page is where Newsletters marked as "Sent" are shown as an archive list.
<p>&nbsp;</p>
<p id="introToModAngPlg"><center><h3>5. Small Introduction to the NS Pro Module & Plugin</h3></center></p>
<table><tr><td>
<p>NS Pro has two main ways to show a subscription form. The Module and the Plugin.</p>
<p>The difference is simple. Use the module if you want to show the form in a side (all module positions) of your site,or use the plugin to include the form in an article.</p>
<p>As of version 1.2, the parameters are very well organized, and easily edited.</p>
<p>Moreover, all parameters have a description that is shown when you move your mouse over the label.</p>
<p>To use the plugin in an article, just write <strong>{newsletter_subscriber_pro}</strong> in that article (and make sure the plugin is enabled)</p>
<p>To use the module in an article, assign it to a custom position and write {loadposition yourcustomposition} in an article. Make sure the Load Module plugin is enabled.</p>
</td><td><img src="img/moduleextensionomitted.png"/></td></tr></table>
<p>&nbsp;</p>
<p id="introToCBPlg"><center><h3>6. Small Introduction to Community Builder Plugin</h3></center></p>
<p>NS Pro has also another way to be used, in combination with the well known Joomla! extension, <a href="http://www.joomlapolis.com/">Community Builder</a>.</p>
<p>NS Pro CB Plugin must be installed in the CB Plugin Installer.</p>
<p>Offers the users the ability to subscribe and edit their mailing lists from their Profile Page.</p>
<p>Most importantly, you can include a Subscribe checkbox and lists in the Register User page.</p>
<p>Also, please check the parameters, (and their descriptions), to find out the abilities to customize the registration page.</p>
<p>&nbsp;</p>
<p id="faqAndErrors"><center><h3>7. FAQ & Common Errors</h3></center></p>
<p id="faq1">
<b>Question #1</b>: What are NS Pro's usage limits?<br/>
<b>Answer #1</b>: I would be a little excessive if I said the limit is the sky :) . To be honest, the only limits are set by your host.<br/>
You can use NS Pro in all your own sites, unlimited domains, unlimited times.<br/>You get unlimited updates, unlimited support and<br/>
you have unlimited lists, unlimited subscribers, unlimited newsletters.<br/>
</p><p id="faq2">
<b>Question #2</b>: It installed just fine. Now what?<br/>
<b>Answer #2</b>: Now please go enable and configure <strong>all 3 extensions</strong> (component, module AND plugin).<br/>
Plase make sure that your Joomla! mail settings are correct. (found in Site->Global Configurations) (<a href="http://demo.mavrosxristoforos.com/index.php?option=com_content&view=article&id=51:configure-joomla-mail-settings&catid=37:nspro-special-help&Itemid=57" target="_blank">Click for more help.</a>)<br/>
</p><p id="faq3">
<b>Question #3</b>: How do I set an unsubscribe page, or any other kind of page?<br/>
<b>Answer #3</b>: By adding a page from the menu item. Choosing type NS Pro and the specific view.<br/>
For unsubscribe pages, you can link directly to index.php?option=com_nspro&layout=unsubscribe<br/>
</p><p id="faq4">
<b>Question #4</b>: What 'Smart Text' can I include in a newsletter?<br/>
<b>Answer #4</b>: As of 1.2.5, the Smart Text is available to see in the Newsletter Edit page, right above the Message Editor.<br/>
Here is the full list:<br/>
<table style="border: 1px dashed #000; background-color: #70DBDB;"><tr><td><h5>Subscriber Smart Text</h5>
<ol><li>Subscriber Name:  {subscriber_name}</li>
<li>Subscriber First Name:  {subscriber_first_name}</li>
<li>Subscriber Last Name: {subscriber_last_name}</li>
<li>Subscriber Email: {subscriber_email}</li>
</ol></td><td>
<h5>Link Smart Text</h5>
<ol><li>One-Click Unsubscribe Link: {link:UNSUB}Your Text here{/link}</li>
<li>Forward to Friend Link: {link:FTF}Your Text here{/link}</li>
<li>Edit List Link: {link:EDITLISTS}Your Text here{/link}</li>
<li>View Newsletter Link: {link:NEWSLETTER}Your Text here{/link}</li>
</ol>
</td></tr><tr><td>
<h5>URL Smart Text</h5>
<ol><li>One-Click Unsubscribe URL:  {url:UNSUB}</li>
<li>Forward to Friend URL:  {url:FTF}</li>
<li>Edit List URL:  {url:EDITLISTS}</li>
<li>View Newsletter URL:  {url:NEWSLETTER}</li>
</ol>
</td><td>
<h5>Email Open Tracking Image</h5>
<ol><li>White 1x1 Image: {img:white}</li>
<li>Black 1x1 Image: {img:black}</li>
<li>Red 1x1 Image: {img:red}</li>
<li>Green 1x1 Image: {img:green}</li>
<li>Blue 1x1 Image:  {img:blue}</li>
</ol>
</td></tr><tr><td>
<h5>Includes</h5>
<ol><li>Joomla! Article: {include:article}article_id{/include}</li>
<li>Joomla! Article Title: {include:articletitle}article_id{/include}</li>
<li>Joomla! Article Intro: {include:articleintro}article_id{/include}</li>
<li>Joomla! Module: {include:module}module_id{/include}</li>
<li>Joomla! Module Position: {include:moduleposition}position_name{/include}</li>
<li>Extra Field Value: {include:field}field_id{/include}</li>
</ol></td>
<td valign="top">
<h5>Special Smart Text</h5>
<ol><li>Random Content Display: {random:50%}Your Content Here{/random}</li>
</ol></td>
</tr></table>
</p><p id="faq5">
<b>Question #5</b>: I get the 'Could not instantiate mail function' error.<br/>
<b>Answer #5</b>: Please make sure that your Joomla! mail settings are correct. (found in Site->Global Configurations)<br/>
If those are correct, check the Mail From parameter, the email recipient (in the module AND the plugin) and also ask your host.<br/>
Feel free to <a href="mailto:mavrosxristoforos@gmail.com?subject=Felt free to drop you a line from NS Pro Help FAQ #5">drop me a line</a>, in this case.. :)<br/>
</p><p id="faq6">
<b>Question #6</b>: I can't send or get any mail. What's wrong?<br/>
<b>Answer #6</b>: Probably the same as Question #5, but your template doesn't handle error printing.. :)<br/>
</p><p id="faq7">
<b>Question #7</b>: I get a blank page or some security issues when I click to subscribe<br/>
<b>Answer #7</b>: The most common problem that causes that is HTTPS enabled servers.<br/>
Go to both the module and the plugin parameters and turn "Disable HTTPS" to Yes.<br/>
</p><p id="faq8">
<b>Question #8</b>: I get a big error that starts with "fopen".. something.<br/>
<b>Answer #8</b>: Actually, reading the error report helps. If it says permission denied,<br/>
then the mailing list file is trying to be saved in a directory with no permissions.<br/>
Make sure the path (found in module and plugin parameters) is correct.<br/>
Remember, a path is not a URL address.<br/>
</p><p id="faq9">
<b>Question #9</b>: What is the correct format for importing subscribers?<br/>
<b>Answer #9</b>: First of all, you can't import using xls files. Only TXT or CSV files are accepted.<br/>
The correct format is:
<pre>Name;Email;DateTime;Confirmed;Mailing List IDs;</pre>
The delimiter is set in the Component Parameters (see <a href="#configuring">Configuring NS Pro</a>).<br/>
Acceptable formats, to import myself, as confirmed, in the Mailing Lists 1 and 3, on date Sept 1 2010 and time 10 and 30 in the morning:<br/>
<pre>Christopher Mavros;mavrosxristoforos@gmail.com;2010-09-01 10:30:00;True;1,3;</pre>
<pre>Christopher Mavros;mavrosxristoforos@gmail.com;Sep 1 2010 10:30 am;Yes;1,3;</pre>
<pre>Christopher Mavros;mavrosxristoforos@gmail.com;Wed, 01 Sep 2010 10:30:00 +0300;T;1,3;</pre>
</p><p id="faq10">
<b>Question #10</b>: I cannot create any subscribers. In the front-end, I get an error about duplicate emails.<br/>
<b>Answer #10</b>: This means one thing: The database table was not correctly created.
This happens if your joomla database user has no ALTER rights on the database. Please grant those rights and install again.
</p><p id="faq11">
<b>Question #11</b>: Can I only show specific lists or no lists at all, in the Subscribe form?<br/>
<b>Answer #11</b>: Sure you can! You should use the Fixed List IDs parameters<span class="modparam">*</span><span class="plgparam">*</span> in the Module &amp; Plugin.
Those settings are very easy to use.
</p><p id="faq12">
<b>Question #12</b>: How can I set an automatic bounced email check for my site?<br/>
<b>Answer #12</b>: Well, it's a piece of cake! Visit <a href="http://demo.mavrosxristoforos.com/obtainkey.php" target="_blank">this page</a>. Get a Bounce Check Key and write it in the Component Parameters<span class="comparam">*</span>.<br/>
Set the Auto Bounce Check to Yes, and make sure the rest of your desired Bounce Address connection parameters are configured (see next question).
</p><p id="faq13">
<b>Question #13</b>: How do I configure a Bounce Address connection?<br/>
<b>Answer #13</b>: Well, in the Component Parameters you can see all the settings you need:
<ol><li>Mail Server</li><li>Mail Server Port</li><li>Connection Protocol</li><li>Mail Server Security (encryption)</li>
<li>Self Signed Certificates</li><li>Mail Server Account Username (usually same as the Bounce Address), and</li><li>Mail Server Account Password</li></ol>
Now, that might seem like a lot of information, but if you don't know where to get it, contact your host and tell them you would like the IMAP connection settings.<br/>
They will provide you with most of the information above, and if you know how to create a new mail account, you can find the rest.<br/>
If you need help, please do not hesitate to <a href="mailto:mavrosxristoforos.com?subject=NS Pro Help. Need help configuring the Bounce Account.">contact me</a> and I'd be happy to help!
</p><p id="faq14">
<b>Question #14</b>: How can I import my subscriber list? What is the format?<br/>
<b>Answer #14</b>: The format is available by clicking the "<a href="../../../index.php?option=com_nspro&task=import_example&type=txt" target="_blank">Click for Import Example</a>" link next to the Import Type, in the Subscriber Manager.
If you need help on formatting your file, please do not hesitate to <a href="mailto:mavrosxristoforos.com?subject=NS Pro Help. Need help on formatting">contact me</a> and I'd be happy to help!
</p><p id="faq15">
<b>Question #15</b>: What is the Cron Job Key and how do I use it?<br/>
<b>Answer #15</b>: The Cron Job Key is a unique key produced by <a href="http://demo.mavrosxristoforos.com/obtainkey.php" target="_blank">this page</a> for your safety.
By using this key, NS Pro at your site and Mavrosxristoforos.com can validate each other and this way your data is safe.<br/>
The Cron Job Key was called Auto Bounce Key in NS Pro 1.3. If you updated from that version and have your key,
you do not have to get a new one. It is the same.<br/>
You should specify this key in your Component Parameters to have your site check
for bounced email addresses and send scheduled newsletters every 30 minutes.
</p><p id="faq16">
<b>Question #16</b>: Can I create multiple unique forms with custom fields?<br/>
<b>Answer #16</b>: Yes! Since version 1.4, you can create your desired extra fields and use the Fixed Field IDs in the module parameters to produce a totally unique form.
You can use different field ids in the module parameters for each form you want to have, and get the data you want for each subscriber!
</p><p id="faq17">
<b>Question #17</b>: Can I show my NS Pro form in a frame, possibly in another site?<br/>
<b>Answer #17</b>: Yes! And it's easier than it sounds! You should call this url:
<span style="color: #3399CC;">index.php?option=com_nspro&tmpl=component</span><br/>
Notice the &tmpl=component part in the url. That can be added in any of your Joomla! pages
to show just the component output, like a single article page or anything.
So, this works too: <span style="color: #3399CC;">index.php?option=com_nspro&layout=unsubscribe&tmpl=component</span>
</p>
<p>&nbsp;</p>
<p id="whatToRemember"><center><h3>8. What you should remember</h3></center></p>
<p>
<ol>
<li>NS Pro works best when all 3 extensions are enabled and configured. The module is the only one that can be omitted.</li>
<li>Your Joomla! db user should have ALTER rights to the database.</li>
<li>The site's Joomla! mail settings must be configured. (Site->Global Configurations) (<a href="http://demo.mavrosxristoforos.com/index.php?option=com_content&view=article&id=51:configure-joomla-mail-settings&catid=37:nspro-special-help&Itemid=57" target="_blank">Click for more help.</a>)</li>
<li>Import, Export and Newsletter Attachments, go to the directory<br/><i>"site_root/administrator/components/com_nspro/uploads"</i><br/>
This directory must have read/write permissions and <strong>any file or attachment will overwrite older with the same name</strong>.</li>
<li>Newsletters that have no list assigned are sent to all subscribers.</li>
<li>Module And Plugin parameters<span class="modparam">*</span><span class="plgparam">*</span> about the List IDs determine the user's ability to select a list, and Fixed Field IDs determine which fields will show.</li>
<li>The confirmation process uses the Plugin parameters<span class="plgparam">*</span>.</li>
<li>The Bounced Email Check is a good way to keep your subscriber list up to date, and is recommended.</li>
<li><strong>Most IMPORTANTLY, remember that I'm always available for help at <a href="mailto:mavrosxristoforos@gmail.com?subject=NS Pro Help.. I need more help.">mavrosxristoforos@gmail.com</a></strong></li>
</ol>
</p>
<p>&nbsp;</p>
<p id="tipsandhints"><center><h3>9. User Tips & Hints</h3></center></p>
<div class="usertipheader">Newsletter List with Not Sent Newsletters <i>by mavrosxristoforos</i></div>
<div class="usertip">
How to make a newsletter that is not sent, show in the Newsletter List view?<br/>
Create a mailing list that contains only one subscriber - you!<br/>
Then, assign the desired newsletter to that list, and hit send!<br/>
The newsletter will appear in the sent Newsletter List view, in the front-end<br/>
That simple!<br/>
</div>
<br/>
<div class="usertipheader">Be sure that your newsletters were sent <i>by bwc2</i></div>
<div class="usertip">
I find it useful to add myself first and last in the subscriber list, before I send a newsletter.<br/>
If I get both emails, then the procedure worked all the way. ;-)<br/>
</div>
<br/>
<div class="usertipheader">Already Sent Newsletters to new subscribers <i>by mavrosxristoforos</i></div>
<div class="usertip">
Did you know you can send old newsletters to subscribers that have subscribed after your sendings?<br/>
If the Sending Status of a newsletter is "Sent", you can click send, again (without clearing the sending status),<br/>
and it will automatically start with your newest subscribers!<br/>
Watch out, though. If you have deleted and re-imported users, they will receive it, too.<br/>
</div>
<br/>
<div class="usertipheader">How can I embed the plugin in an article? <i>by Mario</i></div>
<div class="usertip">
The only thing you need, is to write this in your article at the position of your choice:<br/>
{newsletter_subscriber_pro}<br/>
In case you need the multi-lingual functionality it's necessary to work with the module,<br/>
you're not able to translate the plugin settings by Joomfish.<br/>
</div>
<br/>
<div class="usertipheader">How can I embed the module at a position of my choice in an article? <i>by Mario</i></div>
<div class="usertip">
You need to install another tool such as "Module Anywhere".<br/>
After installing and setup you're able to add the mod_newsletter_subscriber_pro<br/>
(get the Module ID from your back-end) with:<br/>
{module ID}<br/>
</div>
<div class="usertipheader">How should I use the Random Content Display smart text? <i>by mavrosxristoforos</i></div>
<div class="usertip">
NS Pro 1.5's new feature of the random content is unique!<br/>You can use it to send a special image or content to your subscribers<br/>
by percentage. If you want a 10% chance that someone on your list gets something, you just write<br/>
{random:10%}You have been selected to get our 10 year promo T-shirt! Forward this message to us, to claim your gift!{/random}
</div>
<p>Want to help other NS Pro users?</p>
<p><a href="mailto:mavrosxristoforos@gmail.com?subject=Add my tip in NS Pro Help!">Add your tip here!</a></p>
<p>Do you have a custom NS Pro translation to a language that NS Pro is not yet available?<br/>
Please do not hesitate to <a href="mailto:mavrosxristoforos@gmail.com?subject=I have an NS Pro translation I would like to share!">share it</a> with the rest of the NS Pro users!</p>
<p>&nbsp;</p>
<p>Thank you for reading this help file.</p>
<p>Please feel free to contact me if you need anything at all.</p>
<p style="text-align: center;">Copyright 2009-2011: NS Pro by Christopher Mavros<br/>
<a href="http://www.mavrosxristoforos.com">www.mavrosxristoforos.com</a></p>
</div>
</div>
</div>
</body>
</html>